home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / ra_rps01.zip / RA_RPS.DOC < prev    next >
Text File  |  1980-01-01  |  5KB  |  111 lines
  1.                    The RemoteAccess Random Page Selector
  2.                        V.01
  3.                     (C)1990 Sylint Skreemerz' Sophtwear
  4.  
  5.  
  6. What it is:
  7.   The RemoteAccess Random Page Selector is exactly what the name implies.  It
  8. randomly selects a page (from the directory your pagers are in), copies it over
  9. to your RemoteAccess directory, giving it the name of PAGE.RA.
  10.  
  11. How it works:
  12.   The process by which it works is not very complicated.  Matter of fact, I
  13. don't know that much about what I was doing, so here is basically the way that
  14. it works:
  15.     Opens the file PAGE.CTL
  16.     Reads each line into the same variable
  17.        --Just to count the number of pagers
  18.     Then it randomly selects a number between
  19.          1 and the number of pagers.
  20.     It then goes through the list again, this time 
  21.          only to the line number of the random number.
  22.     Takes the line number plus one and pulls the text
  23.          out from that line (plus one is to exclude the path)
  24.     Shells with a statement like, 'SHELL "Copy "+PAGENUM$+" "+RAPATH$'
  25.        --Simple concept.
  26.  
  27. Why I wrote it:
  28.   I wrote this program because I saw so many people in the ECHO RA_SUPPORT
  29. talking about how there program can do this and that, and that it handles so
  30. many pagers, and all that great stuff.  So I thought, if all you want to do
  31. is randomly select a page, why not have a small program to do it?  So I wrote
  32. this to do that purpose.
  33.  
  34. What you need to do:
  35.   First you need to create a directory.  This directory must have atleast the
  36. PAGE.CTL in it.  You can actually have the PAGE.CTL file in any directory.
  37. Most people will prefer to make a special directory so that they can also put
  38. their pagers and the program in it.  You MUST be in the directory that has
  39. PAGE.CTL in it when you run the program!  You must have BRUN45 somewhere in
  40. your path.
  41.  
  42.             This is IMPORTANT!!!!
  43.  
  44. You absolutely MUST have the name of every page that you want to use in the
  45. PAGE.CTL file!  If you have all of your pagers in the directory with PAGE.CTL
  46. then all that is required is the page name and the extension, usually .RA.
  47. If you have your pagers in a directory other that the one that your PAGE.CTL
  48. is in, you must also supply the COMPLETE path to each page.  The first line of
  49. the PAGE.CTL MUST be the complete path to your RemoteAccess directory.  You
  50. cannot put a trailing backslash on the path!  The best way to get all of your
  51. pagers into the file is to do the following:
  52.  
  53. DIR > PAGE.CTL
  54.  
  55. This will put a directory listing into the file PAGE.CTL.  Just edit the file
  56. with a text editor and take out everything that is not needed.  The file should
  57. look like this when completed
  58.  
  59. C:\RA
  60. (page1.pg)
  61. (page2.pg)
  62. (page3.pg)
  63. (page4.pg)
  64. (page5.pg)
  65. (page6.pg)
  66. (page6.pg)
  67. (page7.pg)
  68.  
  69.   The (page?.pg) is the name of the pager, such as AMERICA.RA.
  70.  
  71.   My PAGE.CTL currently has 41 pagers listed, you can have up to 65535.  That
  72. equals out to about a 700k textfile of every file took 12 bytes.  God help you
  73. if you even come close to that number.
  74. A sample PAGE.CTL file IS included....
  75.  
  76. Speed of the program:
  77.   The speed of the prgram is amazingly fast.  I run on a 4.77 Mhz machine with
  78. 256k RAM and 2 floppy drives and it selects 1 page out of the 40 in less than 2 
  79. seconds.  It has also been tested on a AT 12Mhz with 200 Meg drive space.
  80. It only took long enough for the program display it message and it was done.
  81. Also done with 40 pagers.
  82.  
  83. Now the dreaded:
  84.  i gurantee this program to do nothing.  It runs on my system, and that is all
  85. I know of it doing.  If it turns you 4.8 gig hard drive into a Quantum 8" Full
  86. Height 5 Meg, it won't be my problem.
  87.  
  88. A Plug:
  89.   Nothing is asked for the use of this program.  But, if you wish to send, don't
  90. let me stop you.  If you send anything send 3 360k floppy disks.  2 for contri-
  91. bution purposes and 1 so that I can send you back a copy of the latest version
  92. with your BBS name and number on the display.  Please include YOUR name, YOUR
  93. BBS name, BBS phone number, and your, if any, Net/Node number in the form of,
  94. (zone:net/node).  Send to:
  95.               Sylint Skreemerz' Sophtwear
  96.               90 Denise Drive
  97.               Jacksonville, North Carolina  28540
  98.                             USA
  99.  
  100.               C/O Adam Wood
  101.  
  102.   The latest version can be Freq'd from either (1:3614/104) or (1:3614/107),
  103. or be downloaded from The Alfheim BBS (919)577-8172, or The MINUS World
  104. (919)324-1391.  The file to Freq' or D/l is RA_RPS.  Old versions can be
  105. requested as RA_RPS01.* or whatever the version # is of it.
  106.  
  107.   If the programmers of RemoteAccess happen to read this, it would be nice to
  108. for them to drop a line to me:  Adam Wood, letting me know how THEY like the
  109. program...  I can be reached at one of the following nets or phone numbers
  110. above.
  111.